Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Texture and Bitmap Methods

TQABitmapNew

A drawing engine must define a method to create a new bitmap.

typedef TQAError (*TQABitmapNew) (
                                  unsigned long flags, 
                                  TQAImagePixelType pixelType, 
                                  const TQAImage *image, 
                                  TQABitmap **newBitmap);

flags

A set of bit flags specifying features of the new bitmap. See "Bitmap Flags Masks" (page 1-64) for complete information

pixelType

The type of pixels in the new bitmap. See "Pixel Types" (page 1-35) for a description of the values you can pass in this parameter.

image

A pixel image to use for the new bitmap. The width and height fields of this image can have any values greater than 0.

newBitmap

On entry, the address of a pointer variable. On exit, that variable points to a new bitmap. If a new bitmap cannot be created, *newBitmap is set to the value NULL.

DESCRIPTION

Your TQABitmapNew function is called whenever an application calls QABitmapNew. Your function should perform any tasks required to draw the bitmap in the draw context associated with your drawing engine. This might involve loading the bitmap into memory on the device associated with your drawing engine. If so, your TQABitmapNew function should not return until the bitmap has been completely loaded.

The flags parameter specifies a set of bitmap features. If the kQABitmap_Lock bit in that parameter is set but your drawing engine cannot guarantee that the bitmap will remain locked in memory, your TQABitmapNew function should return an error.